home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / x11 / xman~1.lzh / X.MAN
Encoding:
Text File  |  1995-05-01  |  56.2 KB  |  1,220 lines

  1.  
  2.  
  3. X(1)                                                         X(1)
  4.  
  5. NAME
  6.        X - a portable, network-transparent window system
  7.  
  8. SYNOPSIS
  9.        The X Window System is a network transparent window system
  10.        developed at MIT which runs on a wide range  of  computing
  11.        and  graphics machines.  It should be relatively straight-
  12.        forward to build the MIT  software  distribution  on  most
  13.        ANSI  C and POSIX compliant systems.  Commercial implemen-
  14.        tations are also available for a wide range of  platforms.
  15.  
  16.        The X Consortium requests that the following names be used
  17.        when referring to this software:
  18.  
  19.                                    X
  20.                             X Window System
  21.                               X Version 11
  22.                       X Window System, Version 11
  23.                                   X11
  24.  
  25.        X Window System is a trademark of the Massachusetts Insti-
  26.        tute of Technology.
  27.  
  28. DESCRIPTION
  29.        X  Window System servers run on computers with bitmap dis-
  30.        plays.  The server distributes user input to  and  accepts
  31.        output  requests  from  various  client programs through a
  32.        variety of different interprocess communication  channels.
  33.        Although  the  most common case is for the client programs
  34.        to be running on the same machine as the  server,  clients
  35.        can  be  run  transparently from other machines (including
  36.        machines with different architectures and  operating  sys-
  37.        tems) as well.
  38.  
  39.        X  supports  overlapping  hierarchical subwindows and text
  40.        and graphics operations, on both monochrome and color dis-
  41.        plays.   For  a full explanation of the functions that are
  42.        available, see the Xlib - C Language X  Interface  manual,
  43.        the  X Window System Protocol specification, the X Toolkit
  44.        Intrinsics - C  Language  Interface  manual,  and  various
  45.        toolkit documents.
  46.  
  47.        The  number  of  programs that use X is quite large.  Pro-
  48.        grams provided in the core  MIT  distribution  include:  a
  49.        terminal  emulator (xterm), a window manager (twm), a dis-
  50.        play manager (xdm), a console redirect program (xconsole),
  51.        mail  managing  utilities  (xmh  and xbiff), a manual page
  52.        browser (xman), a bitmap editor (bitmap), a resource  edi-
  53.        tor (editres), a ditroff previewer (xditview), access con-
  54.        trol programs (xauth and xhost), user  preference  setting
  55.        programs  (xrdb,  xcmsdb,  xset,  xsetroot,  xstdcmap, and
  56.        xmodmap), a  load  monitor  (xload),  clocks  (xclock  and
  57.        oclock),  a  font  displayer  (xfd), utilities for listing
  58.        information about fonts, windows, and displays  (xlsfonts,
  59.  
  60. X Version 11                Release 5                           1
  61.  
  62. X(1)                                                         X(1)
  63.  
  64.        xfontsel,  xwininfo,  xlsclients,  xdpyinfo, and xprop), a
  65.        diagnostic for seeing what events are generated  and  when
  66.        (xev),  screen  image  manipulation  utilities (xwd, xwud,
  67.        xpr, and  xmag),  and  various  demos  (xeyes,  ico,  xgc,
  68.        x11perf, etc.).
  69.  
  70.        Many  other  utilities,  window managers, games, toolkits,
  71.        etc. are included as user-contributed software in the  MIT
  72.        distribution,  or are available using anonymous ftp on the
  73.        Internet.  See your site administrator for details.
  74.  
  75. STARTING UP
  76.        There are two main ways of getting the  X  server  and  an
  77.        initial  set of client applications started.  The particu-
  78.        lar method used depends on what operating system  you  are
  79.        running and on whether or not you use other window systems
  80.        in addition to X.
  81.  
  82.        xdm (the X Display Manager)
  83.                If you want to always have X running on your  dis-
  84.                play, your site administrator can set your machine
  85.                up to use the X Display Manager xdm.  This program
  86.                is  typically  started  by the system at boot time
  87.                and takes care of keeping the server  running  and
  88.                getting  users logged in.  If you are running xdm,
  89.                you will see a window on the screen welcoming  you
  90.                to  the  system  and  asking for your username and
  91.                password.  Simply type them in as you would  at  a
  92.                normal  terminal,  pressing  the  Return key after
  93.                each.  If you make a mistake, xdm will display  an
  94.                error message and ask you to try again.  After you
  95.                have successfully logged in,  xdm  will  start  up
  96.                your  X  environment.   By default, if you have an
  97.                executable  file  named  .xsession  in  your  home
  98.                directory,  xdm  will  treat  it  as a program (or
  99.                shell script) to run  to  start  up  your  initial
  100.                clients  (such  as  terminal  emulators, clocks, a
  101.                window manager, user settings for things like  the
  102.                background, the speed of the pointer, etc.).  Your
  103.                site administrator can provide details.
  104.  
  105.        xinit (run manually from the shell)
  106.                Sites that support more  than  one  window  system
  107.                might choose to use the xinit program for starting
  108.                X manually.  If this is  true  for  your  machine,
  109.                your  site  administrator  will probably have pro-
  110.                vided a program named "x11", "startx", or "xstart"
  111.                that will do site-specific initialization (such as
  112.                loading convenient default  resources,  running  a
  113.                window  manager,  displaying a clock, and starting
  114.                several terminal emulators) in  a  nice  way.   If
  115.                not,  you  can build such a script using the xinit
  116.                program.   This  utility  simply  runs  one  user-
  117.                specified   program  to  start  the  server,  runs
  118.  
  119. X Version 11                Release 5                           2
  120.  
  121. X(1)                                                         X(1)
  122.  
  123.                another to start up any desired clients, and  then
  124.                waits  for either to finish.  Since either or both
  125.                of the user-specified  programs  may  be  a  shell
  126.                script,  this gives substantial flexibility at the
  127.                expense of a nice  interface.   For  this  reason,
  128.                xinit is not intended for end users.
  129.  
  130. DISPLAY NAMES
  131.        From  the user's prospective, every X server has a display
  132.        name of the form:
  133.  
  134.                   hostname:displaynumber.screennumber
  135.  
  136.        This information is used by the application  to  determine
  137.        how  it  should  connect to the server and which screen it
  138.        should use by default (on  displays  with  multiple  moni-
  139.        tors):
  140.  
  141.        hostname
  142.                The  hostname specifies the name of the machine to
  143.                which the display is physically connected.  If the
  144.                hostname  is  not given, the most efficient way of
  145.                communicating to a server on the same machine will
  146.                be used.
  147.  
  148.        displaynumber
  149.                The  phrase  "display" is usually used to refer to
  150.                collection of monitors that share  a  common  key-
  151.                board  and  pointer  (mouse,  tablet, etc.).  Most
  152.                workstations tend to only have one  keyboard,  and
  153.                therefore,  only  one display.  Larger, multi-user
  154.                systems, however,  will  frequently  have  several
  155.                displays so that more than one person can be doing
  156.                graphics work at once.  To avoid  confusion,  each
  157.                display  on a machine is assigned a display number
  158.                (beginning at 0) when the X server for  that  dis-
  159.                play  is  started.  The display number must always
  160.                be given in a display name.
  161.  
  162.        screennumber
  163.                Some displays share a single keyboard and  pointer
  164.                among  two  or  more monitors.  Since each monitor
  165.                has  its  own  set  of  windows,  each  screen  is
  166.                assigned a screen number (beginning at 0) when the
  167.                X server for that  display  is  started.   If  the
  168.                screen  number is not given, then screen 0 will be
  169.                used.
  170.  
  171.        On POSIX systems, the default display name  is  stored  in
  172.        your  DISPLAY  environment variable.  This variable is set
  173.        automatically by the xterm  terminal  emulator.   However,
  174.        when  you  log  into  another machine on a network, you'll
  175.        need to set DISPLAY by hand to point to your display.  For
  176.        example,
  177.  
  178. X Version 11                Release 5                           3
  179.  
  180. X(1)                                                         X(1)
  181.  
  182.            % setenv DISPLAY myws:0
  183.            $ DISPLAY=myws:0; export DISPLAY
  184.        The  xon  script  can  be  used to start an X program on a
  185.        remote machine; it automatically sets the DISPLAY variable
  186.        correctly.
  187.  
  188.        Finally,  most  X programs accept a command line option of
  189.        -display displayname to temporarily override the  contents
  190.        of  DISPLAY.  This is most commonly used to pop windows on
  191.        another person's screen or as part  of  a  "remote  shell"
  192.        command  to  start an xterm pointing back to your display.
  193.        For example,
  194.  
  195.            % xeyes -display joesws:0 -geometry 1000x1000+0+0
  196.            % rsh big xterm -display myws:0 -ls </dev/null &
  197.  
  198.        X servers listen for connections on a variety of different
  199.        communications channels (network byte streams, shared mem-
  200.        ory, etc.).  Since there can be more than one way of  con-
  201.        tacting  a  given server, The hostname part of the display
  202.        name is used to determine the type of channel (also called
  203.        a  transport  layer) to be used.  X servers generally sup-
  204.        port the following types of connections:
  205.  
  206.        local
  207.                The hostname part of the display  name  should  be
  208.                the empty string.  For example:  :0, :1, and :0.1.
  209.                The most efficient local transport will be chosen.
  210.  
  211.        TCPIP
  212.                The  hostname  part  of the display name should be
  213.                the server machine's IP address name.  Full Inter-
  214.                net names, abbreviated names, and IP addresses are
  215.                all allowed.   For  example:   expo.lcs.mit.edu:0,
  216.                expo:0,     18.30.0.212:0,    bigmachine:1,    and
  217.                hydra:0.1.
  218.  
  219.        DECnet
  220.                The hostname part of the display  name  should  be
  221.                the  server  machine's  nodename  followed  by two
  222.                colons instead of  one.   For  example:   myws::0,
  223.                big::1, and hydra::0.1.
  224.  
  225. ACCESS CONTROL
  226.        An  X  server  can  use  several  types of access control.
  227.        Mechanisms provided in Release 5 are:
  228.            Host Access                   Simple host-based access control.
  229.            MIT-MAGIC-COOKIE-1            Shared plain-text "cookies".
  230.            XDM-AUTHORIZATION-1           Secure DES based private-keys.
  231.            SUN-DES-1                     Based on Sun's secure rpc system.
  232.  
  233.        Xdm initializes access control for the  server,  and  also
  234.        places  authorization  information in a file accessible to
  235.  
  236. X Version 11                Release 5                           4
  237.  
  238. X(1)                                                         X(1)
  239.  
  240.        the user.  Normally, the list of hosts from which  connec-
  241.        tions  are  always  accepted should be empty, so that only
  242.        clients with are explicitly authorized can connect to  the
  243.        display.   When  you  add  entries  to the host list (with
  244.        xhost), the server no longer performs any authorization on
  245.        connections from those machines.  Be careful with this.
  246.  
  247.        The  file  from which Xlib extracts authorization data can
  248.        be specified with the environment variable XAUTHORITY, and
  249.        defaults  to  the  file .Xauthority in the home directory.
  250.        Xdm uses $HOME/.Xauthority and will create it or merge  in
  251.        authorization  records  if  it  already exists when a user
  252.        logs in.
  253.  
  254.        If you use several  machines,  and  share  a  common  home
  255.        directory across all of the machines by means of a network
  256.        file system, then you never really  have  to  worry  about
  257.        authorization  files,  the system should work correctly by
  258.        default.   Otherwise,  as  the  authorization  files   are
  259.        machine-independent,  you  can  simply  copy  the files to
  260.        share them.  To manage  authorization  files,  use  xauth.
  261.        This program allows you to extract records and insert them
  262.        into other files.  Using this, you can send  authorization
  263.        to  remote  machines when you login, if the remote machine
  264.        does not share a common home  directory  with  your  local
  265.        machine.   Note that authorization information transmitted
  266.        ``in the clear'' through a network file  system  or  using
  267.        ftp  or  rcp  can be ``stolen'' by a network eavesdropper,
  268.        and as such may enable unauthorized access.  In many envi-
  269.        ronments  this  level of security is not a concern, but if
  270.        it is, you need to know the exact semantics of the partic-
  271.        ular  authorization  data  to  know  if this is actually a
  272.        problem.
  273.  
  274.        For more information on access control, see the  Xsecurity
  275.        manual page.
  276.  
  277. GEOMETRY SPECIFICATIONS
  278.        One  of  the advantages of using window systems instead of
  279.        hardwired terminals is that applications don't have to  be
  280.        restricted to a particular size or location on the screen.
  281.        Although the layout of windows on a display is  controlled
  282.        by  the window manager that the user is running (described
  283.        below), most X programs accept a command line argument  of
  284.        the  form  -geometry  WIDTHxHEIGHT+XOFF+YOFF (where WIDTH,
  285.        HEIGHT, XOFF, and YOFF are numbers) for specifying a  pre-
  286.        ferred  size and location for this application's main win-
  287.        dow.
  288.  
  289.        The WIDTH and HEIGHT parts of the  geometry  specification
  290.        are  usually  measured  in  either  pixels  or characters,
  291.        depending on the application.  The XOFF and YOFF parts are
  292.        measured in pixels and are used to specify the distance of
  293.        the window from the left or right and top and bottom edges
  294.  
  295. X Version 11                Release 5                           5
  296.  
  297. X(1)                                                         X(1)
  298.  
  299.        of  the  screen,  respectively.  Both types of offsets are
  300.        measured from the indicated edge of the screen to the cor-
  301.        responding edge of the window.  The X offset may be speci-
  302.        fied in the following ways:
  303.  
  304.        +XOFF   The left edge of the window is to be  placed  XOFF
  305.                pixels  in  from the left edge of the screen (i.e.
  306.                the X coordinate of the window's  origin  will  be
  307.                XOFF).   XOFF  may  be negative, in which case the
  308.                window's left edge will be off the screen.
  309.  
  310.        -XOFF   The right edge of the window is to be placed  XOFF
  311.                pixels in from the right edge of the screen.  XOFF
  312.                may be negative, in which case the window's  right
  313.                edge will be off the screen.
  314.  
  315.        The Y offset has similar meanings:
  316.  
  317.        +YOFF   The  top  edge  of the window is to be YOFF pixels
  318.                below the top edge of the screen (i.e. the Y coor-
  319.                dinate of the window's origin will be YOFF).  YOFF
  320.                may be negative, in which case  the  window's  top
  321.                edge will be off the screen.
  322.  
  323.        -YOFF   The bottom edge of the window is to be YOFF pixels
  324.                above the bottom edge of the screen.  YOFF may  be
  325.                negative,  in  which case the window's bottom edge
  326.                will be off the screen.
  327.  
  328.        Offsets must be given as pairs; in other words,  in  order
  329.        to specify either XOFF or YOFF both must be present.  Win-
  330.        dows can be placed in the four corners of the screen using
  331.        the following specifications:
  332.  
  333.        +0+0    upper left hand corner.
  334.  
  335.        -0+0    upper right hand corner.
  336.  
  337.        -0-0    lower right hand corner.
  338.  
  339.        +0-0    lower left hand corner.
  340.  
  341.        In  the  following  examples,  a terminal emulator will be
  342.        placed in roughly the center of  the  screen  and  a  load
  343.        average  monitor, mailbox, and clock will be placed in the
  344.        upper right hand corner:
  345.  
  346.            xterm -fn 6x10 -geometry 80x24+30+200 &
  347.            xclock -geometry 48x48-0+0 &
  348.            xload -geometry 48x48-96+0 &
  349.            xbiff -geometry 48x48-48+0 &
  350.  
  351. X Version 11                Release 5                           6
  352.  
  353. X(1)                                                         X(1)
  354.  
  355. WINDOW MANAGERS
  356.        The layout of windows on the screen is controlled by  spe-
  357.        cial  programs called window managers.  Although many win-
  358.        dow managers will honor geometry specifications as  given,
  359.        others  may  choose  to ignore them (requiring the user to
  360.        explicitly draw the window's region on the screen with the
  361.        pointer, for example).
  362.  
  363.        Since  window managers are regular (albeit complex) client
  364.        programs, a variety of different user  interfaces  can  be
  365.        built.   The  MIT distribution comes with a window manager
  366.        named twm which supports overlapping windows, popup menus,
  367.        point-and-click or click-to-type input models, title bars,
  368.        nice icons (and an icon manager for those who  don't  like
  369.        separate icon windows).
  370.  
  371.        See  the user-contributed software in the MIT distribution
  372.        for other popular window managers.
  373.  
  374. FONT NAMES
  375.        Collections of characters for displaying text and  symbols
  376.        in X are known as fonts.  A font typically contains images
  377.        that share a common appearance and look nice together (for
  378.        example,  a  single  size,  boldness, slant, and character
  379.        set).  Similarly, collections of fonts that are based on a
  380.        common type face (the variations are usually called roman,
  381.        bold, italic, bold italic, oblique, and bold oblique)  are
  382.        called families.
  383.  
  384.        Fonts  come in various sizes.  The X server supports scal-
  385.        able fonts, meaning it is possible to  create  a  font  of
  386.        arbitrary  size  from  a  single source for the font.  The
  387.        server supports scaling  from  outline  fonts  and  bitmap
  388.        fonts.   Scaling  from outline fonts usually produces sig-
  389.        nificantly better results than scaling from bitmap  fonts.
  390.  
  391.        An  X server can obtain fonts from individual files stored
  392.        in directories in the file system, or  from  one  or  more
  393.        font  servers,  or from a mixtures of directories and font
  394.        servers.  The list of places the server looks when  trying
  395.        to  find  a font is controlled by its font path.  Although
  396.        most installations will choose to have the server start up
  397.        with all of the commonly used font directories in the font
  398.        path, the font path can be changed at any  time  with  the
  399.        xset  program.   However, it is important to remember that
  400.        the directory names are on the server's  machine,  not  on
  401.        the application's.  The most common fonts use by X servers
  402.        and font servers can be found in four directories:
  403.  
  404.        /usr/lib/X11/fonts/misc
  405.                This directory contains many miscellaneous  bitmap
  406.                fonts that are useful on all systems.  It contains
  407.                a family of fixed-width fonts, a family of  fixed-
  408.                width  fonts  from  Dale  Schumacher, several Kana
  409.  
  410. X Version 11                Release 5                           7
  411.  
  412. X(1)                                                         X(1)
  413.  
  414.                fonts from Sony Corporation, two JIS Kanji  fonts,
  415.                two  Hangul  fonts  from  Daewoo  Electronics, two
  416.                Hebrew fonts from Joseph  Friedman,  the  standard
  417.                cursor  font, two cursor fonts from Digital Equip-
  418.                ment Corporation, and cursor and glyph fonts  from
  419.                Sun  Microsystems.   It also has various font name
  420.                aliases for the fonts, including fixed  and  vari-
  421.                able.
  422.  
  423.        /usr/lib/X11/fonts/Speedo
  424.                This  directory  contains  outline  fonts for Bit-
  425.                stream's Speedo rasterizer.  A single  font  face,
  426.                in  normal, bold, italic, and bold italic, is pro-
  427.                vided, contributed by Bitstream, Inc.
  428.  
  429.        /usr/lib/X11/fonts/75dpi
  430.                This directory contains bitmap  fonts  contributed
  431.                by Adobe Systems, Inc., Digital Equipment Corpora-
  432.                tion, Bitstream, Inc., Bigelow and Holmes, and Sun
  433.                Microsystems, Inc.  for 75 dots per inch displays.
  434.                An integrated  selection  of  sizes,  styles,  and
  435.                weights are provided for each family.
  436.  
  437.        /usr/lib/X11/fonts/100dpi
  438.                This directory contains 100 dots per inch versions
  439.                of some of the fonts in the 75dpi directory.
  440.  
  441.        Bitmap font files are usually created by compiling a  tex-
  442.        tual  font  description  into binary form, using bdftopcf.
  443.        Font databases are created by running the  mkfontdir  pro-
  444.        gram  in  the  directory containing the source or compiled
  445.        versions of the fonts.  Whenever  fonts  are  added  to  a
  446.        directory,  mkfontdir  should  be rerun so that the server
  447.        can find the new fonts.  To make  the  server  reread  the
  448.        font  database, reset the font path with the xset program.
  449.        For example, to add a font to  a  private  directory,  the
  450.        following commands could be used:
  451.  
  452.            % cp newfont.pcf ~/myfonts
  453.            % mkfontdir ~/myfonts
  454.            % xset fp rehash
  455.  
  456.        The  xfontsel  and xlsfonts programs can be used to browse
  457.        through the fonts available on a server.  Font names  tend
  458.        to  be  fairly long as they contain all of the information
  459.        needed to uniquely identify  individual  fonts.   However,
  460.        the  X  server  supports wildcarding of font names, so the
  461.        full specification
  462.  
  463.            -adobe-courier-medium-r-normal--10-100-75-75-m-60-iso8859-1
  464.  
  465.        might be abbreviated as:
  466.  
  467.            -*-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1
  468.  
  469. X Version 11                Release 5                           8
  470.  
  471. X(1)                                                         X(1)
  472.  
  473.        Because the shell also has special meanings for *  and  ?,
  474.        wildcarded font names should be quoted:
  475.  
  476.            % xlsfonts -fn '-*-courier-medium-r-normal--*-100-*-*-*-*-*-*'
  477.  
  478.        The  xlsfonts program can be used to list all of the fonts
  479.        that match a given pattern.  With no arguments,  it  lists
  480.        all available fonts.  This will usually list the same font
  481.        at many different sizes.  To see just  the  base  scalable
  482.        font names, try using one of the following patterns:
  483.  
  484.            -*-*-*-*-*-*-0-0-0-0-*-0-*-*
  485.            -*-*-*-*-*-*-0-0-75-75-*-0-*-*
  486.            -*-*-*-*-*-*-0-0-100-100-*-0-*-*
  487.  
  488.        To  convert  one  of  the resulting names into a font at a
  489.        specific size, replace one of the first two zeros  with  a
  490.        nonzero value.  The field containing the first zero is for
  491.        the pixel size; replace it with a specific height in  pix-
  492.        els to name a font at that size.  Alternatively, the field
  493.        containing the second zero is for the point size;  replace
  494.        it  with  a  specific  size in decipoints (there are 722.7
  495.        decipoints to the inch) to name a font at that size.   The
  496.        last zero is an average width field, measured in tenths of
  497.        pixels; some servers will  anamorphically  scale  if  this
  498.        value is specified.
  499.  
  500. FONT SERVER NAMES
  501.        One  of  the  following  forms  can be used to name a font
  502.        server that accepts TCP connections:
  503.  
  504.            tcp/hostname:port
  505.            tcp/hostname:port/cataloguelist
  506.  
  507.        The  hostname  specifies  the  name  (or  decimal  numeric
  508.        address)  of  the machine on which the font server is run-
  509.        ning.  The port is the decimal TCP port on which the  font
  510.        server  is  listening  for connections.  The cataloguelist
  511.        specifies a list of catalogue names, with '+' as a separa-
  512.        tor.
  513.  
  514.        Examples:                       tcp/expo.lcs.mit.edu:7000,
  515.        tcp/18.30.0.212:7001/all.
  516.  
  517.        One of the following forms can be  used  to  name  a  font
  518.        server that accepts DECnet connections:
  519.  
  520.            decnet/nodename::font$objname
  521.            decnet/nodename::font$objname/cataloguelist
  522.  
  523.        The  nodename  specifies  the  name  (or  decimal  numeric
  524.        address) of the machine on which the font server  is  run-
  525.        ning.   The  objname  is a normal, case-insensitive DECnet
  526.        object  name.   The  cataloguelist  specifies  a  list  of
  527.  
  528. X Version 11                Release 5                           9
  529.  
  530. X(1)                                                         X(1)
  531.  
  532.        catalogue names, with '+' as a separator.
  533.  
  534.        Examples:         DECnet/SRVNOD::FONT$DEFAULT,        dec-
  535.        net/44.70::font$special/symbols.
  536.  
  537. COLOR NAMES
  538.        Most  applications  provide  ways  of  tailoring  (usually
  539.        through resources or command line arguments) the colors of
  540.        various elements in the text and graphics they display.  A
  541.        color  can  be specified either by an abstract color name,
  542.        or by a  numerical  color  specification.   The  numerical
  543.        specification  can  identify  a  color  in  either device-
  544.        dependent  (RGB)  or  device-independent   terms.    Color
  545.        strings are case-insensitive.
  546.  
  547.        X  supports  the use of abstract color names, for example,
  548.        "red", "blue".  A value for this abstract name is obtained
  549.        by searching one or more color name databases.  Xlib first
  550.        searches zero or more client-side databases;  the  number,
  551.        location, and content of these databases is implementation
  552.        dependent.  If the name is not found, the color is  looked
  553.        up  in  the  X  server's  database.  The text form of this
  554.        database    is    commonly    stored    in    the     file
  555.        /usr/lib/X11/rgb.txt.
  556.  
  557.        A  numerical color specification consists of a color space
  558.        name and a set of values in the following syntax:
  559.  
  560.            <color_space_name>:<value>/.../<value>
  561.  
  562.        An RGB Device specification is identified  by  the  prefix
  563.        "rgb:" and has the following syntax:
  564.  
  565.            rgb:<red>/<green>/<blue>
  566.  
  567.                <red>, <green>, <blue> := h | hh | hhh | hhhh
  568.                h := single hexadecimal digits
  569.        Note  that  h indicates the value scaled in 4 bits, hh the
  570.        value scaled in 8 bits, hhh the value scaled in  12  bits,
  571.        and hhhh the value scaled in 16 bits, respectively.  These
  572.        values are passed  directly  to  the  X  server,  and  are
  573.        assumed to be gamma corrected.
  574.  
  575.        The eight primary colors can be represented as:
  576.  
  577.            black                rgb:0/0/0
  578.            red                  rgb:ffff/0/0
  579.            green                rgb:0/ffff/0
  580.            blue                 rgb:0/0/ffff
  581.            yellow               rgb:ffff/ffff/0
  582.            magenta              rgb:ffff/0/ffff
  583.            cyan                 rgb:0/ffff/ffff
  584.            white                rgb:ffff/ffff/ffff
  585.  
  586. X Version 11                Release 5                          10
  587.  
  588. X(1)                                                         X(1)
  589.  
  590.        For backward compatibility, an older syntax for RGB Device
  591.        is supported, but its continued  use  is  not  encouraged.
  592.        The  syntax is an initial sharp sign character followed by
  593.        a numeric specification, in one of the following formats:
  594.  
  595.            #RGB                      (4 bits each)
  596.            #RRGGBB                   (8 bits each)
  597.            #RRRGGGBBB                (12 bits each)
  598.            #RRRRGGGGBBBB             (16 bits each)
  599.  
  600.        The R, G, and B represent single hexadecimal digits.  When
  601.        fewer  than 16 bits each are specified, they represent the
  602.        most-significant bits of the value (unlike the "rgb:" syn-
  603.        tax,  in  which  values are scaled).  For example, #3a7 is
  604.        the same as #3000a0007000.
  605.  
  606.        An RGB intensity specification is identified by the prefix
  607.        "rgbi:" and has the following syntax:
  608.  
  609.            rgbi:<red>/<green>/<blue>
  610.  
  611.        The red, green, and blue are floating point values between
  612.        0.0 and 1.0, inclusive.  They represent  linear  intensity
  613.        values,  with  1.0  indicating  full  intensity,  0.5 half
  614.        intensity, and so on.  These values  will  be  gamma  cor-
  615.        rected  by  Xlib  before  being sent to the X server.  The
  616.        input format for these  values  is  an  optional  sign,  a
  617.        string of numbers possibly containing a decimal point, and
  618.        an optional exponent field containing an E or  e  followed
  619.        by a possibly signed integer string.
  620.  
  621.        The standard device-independent string specifications have
  622.        the following syntax:
  623.  
  624.            CIEXYZ:<X>/<Y>/<Z>             (none, 1, none)
  625.            CIEuvY:<u>/<v>/<Y>             (~.6, ~.6, 1)
  626.            CIExyY:<x>/<y>/<Y>             (~.75, ~.85, 1)
  627.            CIELab:<L>/<a>/<b>             (100, none, none)
  628.            CIELuv:<L>/<u>/<v>             (100, none, none)
  629.            TekHVC:<H>/<V>/<C>             (360, 100, 100)
  630.  
  631.        All of the values (C, H, V, X, Y, Z, a, b, u, v, y, x) are
  632.        floating point values.  Some of the values are constrained
  633.        to be between zero and some upper bound; the upper  bounds
  634.        are given in parentheses above.  The syntax for these val-
  635.        ues is an optional '+' or '-' sign,  a  string  of  digits
  636.        possibly containing a decimal point, and an optional expo-
  637.        nent field consisting of an 'E'  or  'e'  followed  by  an
  638.        optional '+' or '-' followed by a string of digits.
  639.  
  640.        For  more information on device independent color, see the
  641.        Xlib reference manual.
  642.  
  643. X Version 11                Release 5                          11
  644.  
  645. X(1)                                                         X(1)
  646.  
  647. KEYBOARDS
  648.        The X keyboard model is broken into two  layers:   server-
  649.        specific codes (called keycodes) which represent the phys-
  650.        ical keys, and server-independent symbols (called keysyms)
  651.        which  represent  the  letters or words that appear on the
  652.        keys.  Two tables are kept in the  server  for  converting
  653.        keycodes to keysyms:
  654.  
  655.        modifier list
  656.                Some  keys (such as Shift, Control, and Caps Lock)
  657.                are known as modifier and are used to select  dif-
  658.                ferent  symbols  that are attached to a single key
  659.                (such as Shift-a generates a capital A,  and  Con-
  660.                trol-l  generates  a  control  character ^L).  The
  661.                server keeps a list of keycodes  corresponding  to
  662.                the  various  modifier  keys.   Whenever  a key is
  663.                pressed or released, the server generates an event
  664.                that  contains the keycode of the indicated key as
  665.                well as a mask that specifies which of  the  modi-
  666.                fier keys are currently pressed.  Most servers set
  667.                up this list  to  initially  contain  the  various
  668.                shift,  control,  and  shift lock keys on the key-
  669.                board.
  670.  
  671.        keymap table
  672.                Applications translate event keycodes and modifier
  673.                masks into keysyms using a keysym table which con-
  674.                tains one row for each keycode and one column  for
  675.                various  modifier  states.  This table is initial-
  676.                ized by the server to correspond to  normal  type-
  677.                writer  conventions.   The  exact semantics of how
  678.                the  table  is  interpreted  to  produce   keysyms
  679.                depends  on the particular program, libraries, and
  680.                language input method used, but the following con-
  681.                ventions  for  the  first four keysyms in each row
  682.                are generally adhered to:
  683.  
  684.        The first four elements of the list  are  split  into  two
  685.        groups  of keysyms.  Group 1 contains the first and second
  686.        keysyms; Group 2 contains the third  and  fourth  keysyms.
  687.        Within  each group, if the first element is alphabetic and
  688.        the the second element is  the  special  keysym  NoSymbol,
  689.        then  the  group  is  treated  as equivalent to a group in
  690.        which the first element is the lowercase  letter  and  the
  691.        second element is the uppercase letter.
  692.  
  693.        Switching between groups is controlled by the keysym named
  694.        MODE SWITCH, by attaching that  keysym  to  some  key  and
  695.        attaching  that  key  to  any  one  of  the modifiers Mod1
  696.        through Mod5.  This modifier is called the  ``group  modi-
  697.        fier.''   Group  1 is used when the group modifier is off,
  698.        and Group 2 is used when the group modifier is on.
  699.  
  700.        Within a group, the modifier state determines which keysym
  701.  
  702. X Version 11                Release 5                          12
  703.  
  704. X(1)                                                         X(1)
  705.  
  706.        to  use.  The first keysym is used when the Shift and Lock
  707.        modifiers are off.  The second keysym  is  used  when  the
  708.        Shift modifier is on, when the Lock modifier is on and the
  709.        second keysym is uppercase alphabetic, or  when  the  Lock
  710.        modifier  is  on  and is interpreted as ShiftLock.  Other-
  711.        wise, when the Lock modifier is on and is  interpreted  as
  712.        CapsLock, the state of the Shift modifier is applied first
  713.        to select a keysym; but if that keysym is lowercase alpha-
  714.        betic,  then  the  corresponding  uppercase keysym is used
  715.        instead.
  716.  
  717. OPTIONS
  718.        Most X programs attempt to use the same names for  command
  719.        line options and arguments.  All applications written with
  720.        the X Toolkit Intrinsics automatically accept the  follow-
  721.        ing options:
  722.  
  723.        -display display
  724.                This  option specifies the name of the X server to
  725.                use.
  726.  
  727.        -geometry geometry
  728.                This option specifies the initial size  and  loca-
  729.                tion of the window.
  730.  
  731.        -bg color, -background color
  732.                Either  option  specifies the color to use for the
  733.                window background.
  734.  
  735.        -bd color, -bordercolor color
  736.                Either option specifies the color to use  for  the
  737.                window border.
  738.  
  739.        -bw number, -borderwidth number
  740.                Either option specifies the width in pixels of the
  741.                window border.
  742.  
  743.        -fg color, -foreground color
  744.                Either option specifies the color to use for  text
  745.                or graphics.
  746.  
  747.        -fn font, -font font
  748.                Either  option  specifies the font to use for dis-
  749.                playing text.
  750.  
  751.        -iconic
  752.                This option indicates that the user  would  prefer
  753.                that  the  application's  windows initially not be
  754.                visible as  if  the  windows  had  be  immediately
  755.                iconified by the user.  Window managers may choose
  756.                not to honor the application's request.
  757.  
  758.        -name
  759.                This  option  specifies  the  name   under   which
  760.  
  761. X Version 11                Release 5                          13
  762.  
  763. X(1)                                                         X(1)
  764.  
  765.                resources  for  the  application  should be found.
  766.                This option is useful in shell aliases to  distin-
  767.                guish between invocations of an application, with-
  768.                out resorting to creating links to alter the  exe-
  769.                cutable file name.
  770.  
  771.        -rv, -reverse
  772.                Either  option  indicates  that the program should
  773.                simulate reverse video if possible, often by swap-
  774.                ping  the  foreground  and background colors.  Not
  775.                all programs honor this or implement it correctly.
  776.                It is usually only used on monochrome displays.
  777.  
  778.        +rv
  779.                This  option indicates that the program should not
  780.                simulate reverse video.  This is used to  override
  781.                any  defaults  since  reverse video doesn't always
  782.                work properly.
  783.  
  784.        -selectionTimeout
  785.                This option specifies the timeout in  milliseconds
  786.                within  which  two communicating applications must
  787.                respond to one another for a selection request.
  788.  
  789.        -synchronous
  790.                This option  indicates  that  requests  to  the  X
  791.                server  should  be  sent synchronously, instead of
  792.                asynchronously.   Since  Xlib   normally   buffers
  793.                requests  to the server, errors do not necessarily
  794.                get reported immediately after they  occur.   This
  795.                option  turns off the buffering so that the appli-
  796.                cation can be debugged.  It should never  be  used
  797.                with a working program.
  798.  
  799.        -title string
  800.                This  option  specifies  the  title to be used for
  801.                this window.  This information is  sometimes  used
  802.                by a window manager to provide some sort of header
  803.                identifying the window.
  804.  
  805.        -xnllanguage language[_territory][.codeset]
  806.                This option specifies the language, territory, and
  807.                codeset  for  use  in resolving resource and other
  808.                filenames.
  809.  
  810.        -xrm resourcestring
  811.                This option specifies a resource name and value to
  812.                override any defaults.  It is also very useful for
  813.                setting resources that don't have explicit command
  814.                line arguments.
  815.  
  816. RESOURCES
  817.        To  make the tailoring of applications to personal prefer-
  818.        ences easier, X provides a mechanism for  storing  default
  819.  
  820. X Version 11                Release 5                          14
  821.  
  822. X(1)                                                         X(1)
  823.  
  824.        values  for program resources (e.g. background color, win-
  825.        dow title, etc.)  Resources are specified as strings  that
  826.        are  read  in  from  various places when an application is
  827.        run.  Program components are named in a hierarchical fash-
  828.        ion, with each node in the hierarchy identified by a class
  829.        and an instance name.  At the top level is the  class  and
  830.        instance  name  of the application itself.  By convention,
  831.        the class name of the application is the same as the  pro-
  832.        gram  name,  but  with  the first letter capitalized (e.g.
  833.        Bitmap or Emacs) although some programs  that  begin  with
  834.        the  letter  ``x''  also  capitalize the second letter for
  835.        historical reasons.
  836.  
  837.        The precise syntax for resources is:
  838.  
  839.        ResourceLine    = Comment | IncludeFile | ResourceSpec | <empty line>
  840.        Comment         = "!" {<any character except null or newline>}
  841.        IncludeFile     = "#" WhiteSpace "include" WhiteSpace FileName WhiteSpace
  842.        FileName        = <valid filename for operating system>
  843.        ResourceSpec    = WhiteSpace ResourceName WhiteSpace ":" WhiteSpace Value
  844.        ResourceName    = [Binding] {Component Binding} ComponentName
  845.        Binding         = "." | "*"
  846.        WhiteSpace      = {<space> | <horizontal tab>}
  847.        Component       = "?" | ComponentName
  848.        ComponentName   = NameChar {NameChar}
  849.        NameChar        = "a"-"z" | "A"-"Z" | "0"-"9" | "_" | "-"
  850.        Value           = {<any character except null or unescaped newline>}
  851.  
  852.        Elements separated by vertical bar (|)  are  alternatives.
  853.        Curly  braces ({...}) indicate zero or more repetitions of
  854.        the enclosed elements.  Square brackets  ([...])  indicate
  855.        that the enclosed element is optional.  Quotes ("...") are
  856.        used around literal characters.
  857.  
  858.        IncludeFile lines are interpreted by  replacing  the  line
  859.        with  the  contents  of  the  specified  file.   The  word
  860.        "include" must be in lowercase.  The  filename  is  inter-
  861.        preted  relative to the directory of the file in which the
  862.        line occurs (for example,  if  the  filename  contains  no
  863.        directory or contains a relative directory specification).
  864.  
  865.        If a ResourceName contains a contiguous sequence of two or
  866.        more  Binding  characters,  the  sequence will be replaced
  867.        with single "." character if the  sequence  contains  only
  868.        "."  characters,  otherwise  the sequence will be replaced
  869.        with a single "*" character.
  870.  
  871.        A resource database never contains more than one entry for
  872.        a  given ResourceName.  If a resource file contains multi-
  873.        ple lines with the same ResourceName, the last line in the
  874.        file is used.
  875.  
  876.        Any whitespace character before or after the name or colon
  877.        in a ResourceSpec are ignored.  To allow a Value to  begin
  878.  
  879. X Version 11                Release 5                          15
  880.  
  881. X(1)                                                         X(1)
  882.  
  883.        with  whitespace,  the  two-character  sequence ``\space''
  884.        (backslash followed by space) is recognized  and  replaced
  885.        by  a  space  character,  and  the  two-character sequence
  886.        ``\tab'' (backslash followed by horizontal tab) is  recog-
  887.        nized  and  replaced  by  a  horizontal tab character.  To
  888.        allow a Value to contain embedded newline characters,  the
  889.        two-character  sequence  ``\n'' is recognized and replaced
  890.        by a newline character.  To allow a  Value  to  be  broken
  891.        across  multiple  lines  in a text file, the two-character
  892.        sequence ``\newline'' (backslash followed by  newline)  is
  893.        recognized  and  removed from the value.  To allow a Value
  894.        to contain arbitrary character codes,  the  four-character
  895.        sequence  ``\nnn'',  where  each n is a digit character in
  896.        the range of ``0''-``7'', is recognized and replaced  with
  897.        a  single  byte that contains the octal value specified by
  898.        the sequence.  Finally, the two-character sequence  ``\\''
  899.        is recognized and replaced with a single backslash.
  900.  
  901.        When  an application looks for the value of a resource, it
  902.        specifies a complete path  in  the  hierarchy,  with  both
  903.        class  and  instance  names.  However, resource values are
  904.        usually given with  only  partially  specified  names  and
  905.        classes,  using  pattern matching constructs.  An asterisk
  906.        (*) is a loose binding and is used to represent any number
  907.        of  intervening  components, including none.  A period (.)
  908.        is a tight binding and is  used  to  separate  immediately
  909.        adjacent components.  A question mark (?) is used to match
  910.        any single component name or class.  A database entry can-
  911.        not  end  in  a  loose binding; the final component (which
  912.        cannot be "?") must be specified.   The  lookup  algorithm
  913.        searches  the  resource  database  for the entry that most
  914.        closely matches (is most specific for) the full  name  and
  915.        class  being  queried.   When more than one database entry
  916.        matches the full name and class, precedence rules are used
  917.        to select just one.
  918.  
  919.        The  full  name  and  class are scanned from left to right
  920.        (from highest level in the hierarchy to lowest), one  com-
  921.        ponent at a time.  At each level, the corresponding compo-
  922.        nent and/or binding of each matching entry is  determined,
  923.        and  these  matching  components and bindings are compared
  924.        according to precedence  rules.   Each  of  the  rules  is
  925.        applied  at  each  level, before moving to the next level,
  926.        until a rule selects a single entry over all others.   The
  927.        rules (in order of precedence) are:
  928.  
  929.        1.   An  entry that contains a matching component (whether
  930.             name, class, or "?")  takes precedence  over  entries
  931.             that elide the level (that is, entries that match the
  932.             level in a loose binding).
  933.  
  934.        2.   An entry with a matching name takes  precedence  over
  935.             both  entries  with a matching class and entries that
  936.             match using "?".  An  entry  with  a  matching  class
  937.  
  938. X Version 11                Release 5                          16
  939.  
  940. X(1)                                                         X(1)
  941.  
  942.             takes precedence over entries that match using "?".
  943.  
  944.        3.   An entry preceded by a tight binding takes precedence
  945.             over entries preceded by a loose binding.
  946.  
  947.        Programs based on the X Tookit Intrinsics obtain resources
  948.        from the following sources (other programs usually support
  949.        some subset of these sources):
  950.  
  951.        RESOURCE_MANAGER root window property
  952.                Any global resources that should be  available  to
  953.                clients  on  all  machines should be stored in the
  954.                RESOURCE_MANAGER property on the  root  window  of
  955.                the  first screen using the xrdb program.  This is
  956.                frequently taken care of when the user starts up X
  957.                through the display manager or xinit.
  958.  
  959.        SCREEN_RESOURCES root window property
  960.                Any  resources  specific  to  a given screen (e.g.
  961.                colors) that should be available to clients on all
  962.                machines  should be stored in the SCREEN_RESOURCES
  963.                property on the root window of that  screen.   The
  964.                xrdb program will sort resources automatically and
  965.                place     them     in     RESOURCE_MANAGER      or
  966.                SCREEN_RESOURCES, as appropriate.
  967.  
  968.        application-specific files
  969.                Directories  named  by  the  environment  variable
  970.                XUSERFILESEARCHPATH or  the  environment  variable
  971.                XAPPLRESDIR,  plus directories in a standard place
  972.                (usually under  /usr/lib/X11/,  but  this  can  be
  973.                overridden  with  the  XFILESEARCHPATH environment
  974.                variable)  are  searched  for   for   application-
  975.                specific   resources.   For  example,  application
  976.                default   resources   are    usually    kept    in
  977.                /usr/lib/X11/app-defaults/.   See  the  X  Toolkit
  978.                Intrinsics  -  C  Language  Interface  manual  for
  979.                details.
  980.  
  981.        XENVIRONMENT
  982.                Any  user-  and  machine-specific resources may be
  983.                specified by setting the XENVIRONMENT  environment
  984.                variable  to  the  name  of  a resource file to be
  985.                loaded by all applications.  If this  variable  is
  986.                not   defined,   a  file  named  $HOME/.Xdefaults-
  987.                hostname is looked for instead, where hostname  is
  988.                the name of the host where the application is exe-
  989.                cuting.
  990.  
  991.        -xrm resourcestring
  992.                Resources can also be specified from  the  command
  993.                line.   The  resourcestring  is  a single resource
  994.                name and value as shown above.  Note that  if  the
  995.                string  contains  characters  interpreted  by  the
  996.  
  997. X Version 11                Release 5                          17
  998.  
  999. X(1)                                                         X(1)
  1000.  
  1001.                shell (e.g., asterisk), they must be quoted.   Any
  1002.                number  of -xrm arguments may be given on the com-
  1003.                mand line.
  1004.  
  1005.        Program  resources  are  organized  into   groups   called
  1006.        classes, so that collections of individual resources (each
  1007.        of which are called instances) can be set all at once.  By
  1008.        convention,  the instance name of a resource begins with a
  1009.        lowercase letter and class name with an upper case letter.
  1010.        Multiple  word  resources  are concatenated with the first
  1011.        letter of the succeeding words capitalized.   Applications
  1012.        written  with  the X Toolkit Intrinsics will have at least
  1013.        the following resources:
  1014.  
  1015.        background (class Background)
  1016.                This resource specifies the color to use  for  the
  1017.                window background.
  1018.  
  1019.        borderWidth (class BorderWidth)
  1020.                This resource specifies the width in pixels of the
  1021.                window border.
  1022.  
  1023.        borderColor (class BorderColor)
  1024.                This resource specifies the color to use  for  the
  1025.                window border.
  1026.  
  1027.        Most applications using the X Toolkit Intrinsics also have
  1028.        the resource foreground (class Foreground), specifying the
  1029.        color to use for text and graphics within the window.
  1030.  
  1031.        By  combining  class and instance specifications, applica-
  1032.        tion preferences can be set quickly and easily.  Users  of
  1033.        color  displays will frequently want to set Background and
  1034.        Foreground classes to particular defaults.  Specific color
  1035.        instances  such  as  text  cursors  can then be overridden
  1036.        without having to define all  of  the  related  resources.
  1037.        For example,
  1038.  
  1039.            bitmap*Dashed:  off
  1040.            XTerm*cursorColor:  gold
  1041.            XTerm*multiScroll:  on
  1042.            XTerm*jumpScroll:  on
  1043.            XTerm*reverseWrap:  on
  1044.            XTerm*curses:  on
  1045.            XTerm*Font:  6x10
  1046.            XTerm*scrollBar: on
  1047.            XTerm*scrollbar*thickness: 5
  1048.            XTerm*multiClickTime: 500
  1049.            XTerm*charClass:  33:48,37:48,45-47:48,64:48
  1050.            XTerm*cutNewline: off
  1051.            XTerm*cutToBeginningOfLine: off
  1052.  
  1053. X Version 11                Release 5                          18
  1054.  
  1055. X(1)                                                         X(1)
  1056.  
  1057.            XTerm*titeInhibit:  on
  1058.            XTerm*ttyModes:  intr ^c erase ^? kill ^u
  1059.            XLoad*Background: gold
  1060.            XLoad*Foreground: red
  1061.            XLoad*highlight: black
  1062.            XLoad*borderWidth: 0
  1063.            emacs*Geometry:  80x65-0-0
  1064.            emacs*Background:  rgb:5b/76/86
  1065.            emacs*Foreground:  white
  1066.            emacs*Cursor:  white
  1067.            emacs*BorderColor:  white
  1068.            emacs*Font:  6x10
  1069.            xmag*geometry: -0-0
  1070.            xmag*borderColor:  white
  1071.  
  1072.        If  these  resources  were  stored  in a file called .Xre-
  1073.        sources in your home directory, they could be added to any
  1074.        existing  resources  in the server with the following com-
  1075.        mand:
  1076.  
  1077.            % xrdb -merge $HOME/.Xresources
  1078.  
  1079.        This is frequently how user-friendly startup scripts merge
  1080.        user-specific  defaults  into any site-wide defaults.  All
  1081.        sites are encouraged to set up convenient ways of automat-
  1082.        ically  loading  resources.  See  the  Xlib manual section
  1083.        Resource Manager Functions for more information.
  1084.  
  1085. EXAMPLES
  1086.        The following is a collection of sample command lines  for
  1087.        some  of  the  more  frequently  used  commands.  For more
  1088.        information on a particular command, please refer to  that
  1089.        command's manual page.
  1090.  
  1091.            %  xrdb $HOME/.Xresources
  1092.            %  xmodmap -e "keysym BackSpace = Delete"
  1093.            %  mkfontdir /usr/local/lib/X11/otherfonts
  1094.            %  xset fp+ /usr/local/lib/X11/otherfonts
  1095.            %  xmodmap $HOME/.keymap.km
  1096.            %  xsetroot -solid 'rgbi:.8/.8/.8'
  1097.            %  xset b 100 400 c 50 s 1800 r on
  1098.            %  xset q
  1099.            %  twm
  1100.            %  xmag
  1101.            %  xclock -geometry 48x48-0+0 -bg blue -fg white
  1102.            %  xeyes -geometry 48x48-48+0
  1103.            %  xbiff -update 20
  1104.            %  xlsfonts '*helvetica*'
  1105.            %  xwininfo -root
  1106.            %  xdpyinfo -display joesworkstation:0
  1107.            %  xhost -joesworkstation
  1108.            %  xrefresh
  1109.            %  xwd | xwud
  1110.            %  bitmap companylogo.bm 32x32
  1111.  
  1112. X Version 11                Release 5                          19
  1113.  
  1114. X(1)                                                         X(1)
  1115.  
  1116.            %  xcalc -bg blue -fg magenta
  1117.            %  xterm -geometry 80x66-0-0 -name myxterm $*
  1118.            %  xon filesysmachine xload
  1119.  
  1120. DIAGNOSTICS
  1121.        A  wide variety of error messages are generated from vari-
  1122.        ous programs.  The default error  handler  in  Xlib  (also
  1123.        used  by  many  toolkits)  uses standard resources to con-
  1124.        struct  diagnostic  messages  when  errors   occur.    The
  1125.        defaults   for   these  messages  are  usually  stored  in
  1126.        /usr/lib/X11/XErrorDB.  If this file is not present, error
  1127.        messages will be rather terse and cryptic.
  1128.  
  1129.        When  the X Toolkit Intrinsics encounter errors converting
  1130.        resource strings to the appropriate  internal  format,  no
  1131.        error  messages  are  usually printed.  This is convenient
  1132.        when it is desirable to have one set of resources across a
  1133.        variety  of  displays  (e.g. color vs. monochrome, lots of
  1134.        fonts vs. very few, etc.), although it can  pose  problems
  1135.        for  trying to determine why an application might be fail-
  1136.        ing.  This behavior can be overridden by the  setting  the
  1137.        StringConversionsWarning resource.
  1138.  
  1139.        To  force  the X Toolkit Intrinsics to always print string
  1140.        conversion error messages, the following  resource  should
  1141.        be   placed   in  the  file  that  gets  loaded  onto  the
  1142.        RESOURCE_MANAGER property using  the  xrdb  program  (fre-
  1143.        quently  called  .Xresources  or  .Xres in the user's home
  1144.        directory):
  1145.  
  1146.            *StringConversionWarnings: on
  1147.  
  1148.        To have conversion messages printed for just a  particular
  1149.        application,  the  appropriate instance name can be placed
  1150.        before the asterisk:
  1151.  
  1152.            xterm*StringConversionWarnings: on
  1153.  
  1154. SEE ALSO
  1155.        XConsortium(1),  XStandards(1),  Xsecurity(1),  appres(1),
  1156.        auto_box(1),    bdftopcf(1),   beach_ball(1),   bitmap(1),
  1157.        editres(1), fs(1),  fsinfo(1),  fslsfonts(1),  fstobdf(1),
  1158.        ico(1),  imake(1),  listres(1),  lndir(1),  makedepend(1),
  1159.        maze(1), mkdirhier(1), mkfontdir(1), oclock(1), plbpex(1),
  1160.        puzzle(1),  resize(1),  showfont(1),  showrgb(1),  twm(1),
  1161.        viewres(1),    x11perf(1),    x11perfcomp(1),    xauth(1),
  1162.        xbiff(1),  xcalc(1),  xclipboard(1), xclock(1), xcmsdb(1),
  1163.        xcmstest(1), xconsole(1), xcutsel(1), xditview(1), xdm(1),
  1164.        xdpr(1),  xdpyinfo(1), xedit(1), xev(1), xeyes(1), xfd(1),
  1165.        xfontsel(1),   xgas(1),   xgc(1),   xhost(1),    xinit(1),
  1166.        xkill(1),  xload(1), xlogo(1), xlsatoms(1), xlsclients(1),
  1167.        xlsfonts(1),   xmag(1),   xman(1),    xmh(1),    xmkmf(1),
  1168.        xmodmap(1),   xon(1),   xpr(1),  xprop(1),  xrdb(1),  xre-
  1169.        fresh(1),  xset(1),  xsetroot(1),  xstdcmap(1),  xterm(1),
  1170.  
  1171. X Version 11                Release 5                          20
  1172.  
  1173. X(1)                                                         X(1)
  1174.  
  1175.        xwd(1),   xwininfo(1),   xwud(1),   Xserver(1),   Xdec(1),
  1176.        XmacII(1), Xmips(1), Xqdss(1), Xqvss(1), Xsun(1), X386(1),
  1177.        kbd_mode(1),  Xlib - C Language X Interface, and X Toolkit
  1178.        Intrinsics - C Language Interface
  1179.  
  1180. COPYRIGHT
  1181.        The following copyright and permission notice outlines the
  1182.        rights  and  restrictions  covering most parts of the core
  1183.        distribution of the X Window System from MIT.  Other parts
  1184.        have  additional  or different copyrights and permissions;
  1185.        see the individual source files.
  1186.  
  1187.        Copyright 1984, 1985, 1986, 1987, 1988, 1989,  1990,  1991
  1188.        by the Massachusetts Institute of Technology.
  1189.  
  1190.        Permission to use, copy, modify, distribute, and sell this
  1191.        software and its documentation for any purpose  is  hereby
  1192.        granted  without  fee,  provided  that the above copyright
  1193.        notice appear in all copies and that both  that  copyright
  1194.        notice  and  this  permission  notice appear in supporting
  1195.        documentation, and that the name of MIT  not  be  used  in
  1196.        advertising or publicity pertaining to distribution of the
  1197.        software without specific, written prior permission.   MIT
  1198.        makes  no  representations  about  the suitability of this
  1199.        software for any purpose.  It is provided "as is"  without
  1200.        express or implied warranty.
  1201.  
  1202. TRADEMARKS
  1203.        X Window System is a trademark of MIT.
  1204.  
  1205. AUTHORS
  1206.        A cast of thousands, literally.  The MIT Release 5 distri-
  1207.        bution is brought to you by the  MIT  X  Consortium.   The
  1208.        names of all people who made it a reality will be found in
  1209.        the individual documents and source files.  The staff mem-
  1210.        bers  at  MIT responsible for this release are: Donna Con-
  1211.        verse (MIT X Consortium), Stephen Gildea  (MIT  X  Consor-
  1212.        tium),  Susan  Hardy  (MIT X Consortium), Jay Hersh (MIT X
  1213.        Consortium),  Keith  Packard  (MIT  X  Consortium),  David
  1214.        Sternlicht  (MIT  X Consortium), Bob Scheifler (MIT X Con-
  1215.        sortium), and Ralph Swick (Digital/MIT Project Athena).
  1216.  
  1217. X Version 11                Release 5                          21
  1218.  
  1219. (END)
  1220.